API Payment QR

Berfunsi untuk melakukan pembayaran via QR

info

respon akan di dapat setelah user melakukan input pin, halaman input pin akan di informasikan terpisah, akan timeout setelah 5 menit tidak ada pin yang terinput di halaman pin

Sequence Diagram

Bagian berikut akan menjelaskan tentang detail teknis untuk proses transfer bank.

note

Pastikan partnerReferenceNo pada request dan params di url input pin sama agar terproses

Service Info

HTTP Method	POST
Service Code	48
Http Method	POST
Path	...{version}/qr/qr-mpm-payment

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
Authorization	String	Y	Token B2B
Authorization-Customer	String	Y	Token B2B2C
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token B2B2C: Signature Generation
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-EXTERNAL-ID	String	Y	Nomor referensi yang harus unik pada hari yg sama
CHANNEL-ID	String	Y	00001 untuk PJP and 00002 untuk non PJP

Body

Parameter	Tipe Data	Wajib	Deskripsi
partnerReferenceNo	String	Y	Kode Transaksi Partner
merchantId	String	Y	Kode unik yang dimiliki setiap user Length: <= 64 characters
amount	Object	Y	Nominal Transaksi
feeAmount	Object	C	Nominal fee
additionalInfo	Object	Y
referenceNo	Object	Y	Kode SpeedCash saat decode qr

Request samples

JSON

{
  "partnerReferenceNo": "12327777132132",
  "merchantId": "1212723",
  "amount": {
    "value": "12000.00",
    "currency": "IDR"
  },
  "feeAmount": {
    "value": "10",
    "currency": "IDR"
  },
  "additionalInfo": {
    "referenceNo": "5037338",
  }
}

CURL

curl --location --request POST '../v1.0/qr/qr-mpm-payment' \
--header 'X-TIMESTAMP: 2023-01-25T13:51:00+07:00' \
--header 'X-SIGNATURE: RwABEherf+3MTBhIf6vtju6ko+YOFFKWLGgHCD5RwX1I17JCKVn8ffc/TenEIly85InhuIcKCDqDrxbIBhaKEg==' \
--header 'X-PARTNER-ID: 085224a9-4b42-4f7d-959f-4452f8a9a1ff' \
--header 'X-EXTERNAL-ID: c44680a5-22fc-4f8d-8fd2-f053ff477774' \
--header 'X-DEVICE-ID: android-20013adf6cdd8123f' \
--header 'CHANNEL-ID: 12345' \
--header 'Authorization: Bearer bb005fcb-dea9-499a-9e7a-bcf651b2334e' \
--header 'Authorization-Customer:Bearer 5b8bbaf8-4aca-4072-9ea8-d85bed65105f' \
--header 'Content-Type: application/json' \
--data '{
    "partnerReferenceNo": "1233xxxxx",
    "merchantId": "121xxxx",
    "amount": {
        "value": "12000.00",
        "currency": "IDR"
    },
    "feeAmount": {
        "value": "10",
        "currency": "IDR"
    },
    "additionalInfo": {
        "referenceNo": "5037213",
    }
}'

```

Response Structure

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode respons Length: <= 7 karakter
responseMessage	String	Deskripsi respons Length: <= 150 karakter
referenceNo	String	kode transaksi SpeedCash: <= 64 karakter
partnerReferenceNo	String	kode transaksi Partner Length: <= 32 karakter
amount	Object	Jumlah
feeAmount	Object	Jumlah Fee / tips

Response samples

{
  "responseCode": "2005000",
  "responseMessage": "Successful",
  "referenceNo": "5037213",
  "transactionDate":"2025-04-20T18:22:05.000+07:00",
  "amount": {
    "value\"": "12000.00",
    "currency\"": "IDR"
  },
  "feeAmount\"": {
    "value\"": "10",
    "currency\"": "IDR"
  }
}

List Response Code API Payment - Host to Host

Response Code	Response Message	Description
2005000	Success	Sukses
4005001	Invalid field format { field name }	Format invalid
4005002	Invalid mandatory field {field name}	Format pada bidang wajib tidak ada atau tidak valid
4015000	Unauthorized. Invalid Signature	X-Signature salah
4095000	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4045001	Bad Request	Request header ada yang salah / kurang
4045001	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait